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1. INTRODUCTION. 



This manual describes CP/M, release 2, system organization 
including the structure of memory and system entry points. The 
intention is to provide the necessary information required to write 
programs which operate under CP/M, and which use the peripheral and 
disk I/O facilities of the system. 

CP/M is logically divided into four parts, called the Basic I/O 
System (BIOS) , the Basic Disk Operating System (BDOS) , the Console 
command processor (CCP) , and the Transient Program Area (TPA). The 
BIOS is a hardware-dependent module which defines the exact low level 
interface to a particular computer system which is necessary for 
peripheral device I/O. Although a standard BIOS is supplied by 
Digital Research, explicit instructions are provided for field 
reconfiguration of the BIOS to match nearly any hardware environment 
(see the Digital Research manual entitled "CP/M Alteration Guide"). 
The BIOS and BDOS are logically combined into a single module with a 
common entry point, and referred to as the FDOS. The CCP is a 
distinct program which uses the FDOS to provide a human-oriented 
interface to the information which is cataloged on the backup storage 
device. The TPA is an area of memory (i.e., the portion which is not 
used by the FDOS and CCP) where various non-resident operating system 
commands and user programs are executed. The lower portion of memory 
is reserved for system information and is detailed later sections. 
Memory organization of the CP/M system in shown below: 



high 
memory 

FBASE: 



FDOS (BDOS+BIOS) 



CBASE: 



TBASE: 



CCP 



TPA 



BOOT: 



system parameters 



The exact memory addresses corresponding to BOOT, TBASE, CBASE, and 
FBASE vary from version to version, and are described fully in the 
"CP/M Alteration Guide." All standard CP/M versions, however, assume 
BOOT = 0000H, which is the base of random access memory. The machine 
code found at location BOOT performs a system "warm start" which loads 
and initializes the programs and variables necessary to return control 
to the CCP. Thus, transient programs need only jump to location BOOT 
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to return control to CP/M at the command level. Further, the standard 
versions assume TBASE = BOOT+0100H which is normally location 0100H. 
The principal entry point to the FDOS is at location BOOT+0005H 
(normally 0005H) where a jump to FBASE is found. The address field at 
BOOT+0006H (normally 0006H) contains the value of FBASE and can be 
used to determine the size of available memory, assuming the CCP is 
being overlayed by a transient program. 

Transient programs are loaded into the TPA and executed as 
follows. The operator communicates with the CCP by typing command 
lines following each prompt. Each command line takes one of the 
forms : 

command 
command filel 
command filel file2 

where "command" is either a built-in function such as DIR or TYPE, or 
the name of a transient command or program. If the command is a 
built-in function of CP/M, it is executed immediately. Otherwise, the 
CCP searches the currently addressed disk for a file by the name 

command. COM 

If the file is found, it is assumed to be a memory image of a program 
which executes in the TPA, and thus implicitly originates at TBASE in 
memory. The CCP loads the COM file from the disk into memory starting 
at TBASE and possibly extending up to CBASE. 

If the command is followed by one or two file specifications, 
the CCP prepares one or two file control block (FCB) names in the 
system parameter area. These optional FCB's are in the form necessary 
to access files through the FDOS, and are described in the next 
section. 

The transient program receives control from the CCP and begins 
execution, perhaps using the I/O facilities of the FDOS. The 
transient program is "called" from the CCP, and thus can simply return 
to the CCP upon completion of its processing, or can jump to BOOT to 
pass control back to CP/M. In the first case, the transient program 
must not use memory above CBASE, while in the latter case, memory up 
through FBASE- 1 is free. 

The transient program may use the CP/M I/O facilities to 
communicate with the operator's console and peripheral devices, 
including the disk subsystem. The I/O system is accessed by passing a 
"function number" and an "information address" to CP/M through the 
FDOS entry point at BOOT+0005H. In the case of a disk read, for 
example, the transient program sends the number corresponding to a 
disk read, along with the address of an FCB to the CP/M FDOS. The 
FDOS, in turn, performs the operation and returns with either a disk 
read completion indication or an error number indicating that the disk 
read was unsuccessful. The function numbers and error indicators are 
given in below. 
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2. OPERATING SYSTEM CALL CONVENTIONS. 

The purpose of this section is to provide detailed information 
for performing direct operating system calls from user programs. Many 
of the functions listed below, however, are more simply accessed 
through the I/O macro library provided with the MAC macro assembler, 
and listed in the Digital Research manual entitled "MAC Macro 
Assembler: Language Manual and Applications Guide." 

CP/M facilities which are available for access by transient 
programs fall into two general categories: simple device I/O, and 
disk file I/O. The simple device operations include: 

Read a Console Character 

Write a Console Character 

Read a Sequential Tape Character 

Write a Sequential Tape Character 

Write a List Device Character 

Get or Set I/O Status 

Print Console Buffer 

Read Console Buffer 

Interrogate Console Ready 

The FDOS operations which perform disk Input/Output are 

Disk System Reset 
Drive Selection 
File Creation 
File Open 
File Close 
Directory Search 
File Delete 
File Rename 

Random or Sequential Read 
Random or Sequential Write 
Interrogate Available Disks 
Interrogate Selected Disk 
Set DMA Address 
Set/Reset File Indicators 

As mentioned above, access to the FDOS functions is accomplished 
by passing a function number and information address through the 
primary entry point at location BOOT+0005H. In general, the function 
number is passed in register C with the information address in the 
double byte pair DE. Single byte values are returned in register A, 
with double byte values returned in HL (a zero value is returned when 
the function number is out of range) . For reasons of compatibility, 
register A = L and register B = H upon return in all cases. Note that 
the register passing conventions of CP/M agree with those of Intel's 
PL/M systems programming language. The list of CP/M function numbers 
is given below. 
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(Functions 28 and 32 should be avoided in application programs to 
maintain upward compatibility with MP/M.) 

Upon entry to a transient program, the CCP leaves the stack 
pointer set to an eight level stack area with the CCP return address 
pushed onto the stack, leaving seven levels before overflow occurs. 
Although this stack is usually not used by a transient program (i.e., 
most transients return to the CCP though a jump to location 0000H) , it 
is sufficiently large to make CP/M system calls since the FDOS 
switches to a local stack at system entry. The following assembly 
language program segment, for example, reads characters continuously 
until an asterisk is encountered, at which time control returns to the 
CCP (assuming a standard CP/M system with BOOT = 0000H): 



BDOS 


EQU 


0005H 


; STANDARD CP/M ENTRY 


CONIN 


EQU 


1 


;C0NS0LE INPUT FUNCTION 




ORG 


0100H 


; BASE OF TPA 


NEXTC: 


MVI 


C, CONIN 


; READ NEXT CHARACTER 




CALL 


BDOS 


; RETURN CHARACTER IN <A> 




CP I 


• * • 


; END OF PROCESSING? 




JNZ 


NEXTC 


;L00P IF NOT 




RET 




; RETURN TO CCP 




END 







CP/M implements a named file structure on each disk, providing a 
logical organization which allows any particular file to contain any 
number of records from completely empty, to the full capacity of the 
drive. Each drive is logically distinct with a disk directory and 
file data area. The disk file names are in three parts: the drive 
select code, the file name consisting of one to eight non-blank 
characters, and the file type consisting of zero to three non-blank 
characters. The file type names the generic category of a particular 
file, while the file name distinguishes individual files in each 
category. The file types listed below name a few generic categories 
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which have been established, although they are generally arbitrary: 



ASM Assembler Source 

PRN Printer Listing 

HEX Hex Machine Code 

BAS Basic Source File 

INT Intermediate Code 

COM CCP Command File 



PLI PL/I Source File 

REL Relocatable Module 

TEX TEX Formatter Source 

BAK ED Source Backup 

SYM SID Symbol File 

$$$ Temporary File 



Source files are treated as a sequence of ASCII characters, where each 
"line" of the source file is followed by a carriage-return line-feed 
sequence { 0DH followed by 0AH) . Thus one 128 byte CP/M record could 
contain several lines of source text. The end of an ASCII file is 
denoted by a control-Z character (1AH) or a real end of file, returned 
by the CP/M read operation. Control-Z characters embedded within 
machine code files (e.g., COM files) are ignored, however, and the end 
of file condition returned by CP/M is used to terminate read 
operations. 

Files in CP/M can be thought of as a sequence of up to 65536 
records of 128 bytes each, numbered from 0 through 65535, thus 
allowing a maximum of 8 megabytes per file. Note, however, that 
although the records may be considered logically contiguous, they may 
not be physically contiguous in the disk data area. Internally, all 
files are broken into 16K byte segments called logical extents, so 
that counters are easily maintained as 8-bit values. Although the 
decomposition into extents is discussed in the paragraphs which 
follow, they are of no particular consequence to the programmer since 
each extent is automatically accessed in both sequential and random 
access modes. 



In the file operations starting with function number 15, DE 
usually addresses a file control block (FCB) . Transient programs 
often use the default file control block area reserved by CP/M at 
location BOOT+005CH (normally 005CH) for simple file operations. The 
basic unit of file information is a 128 byte record used for all file 
operations, thus a default location for disk I/O is provided by CP/M 
at location BOOT+0080H (normally 0080H) which is the initial default 
DMA address (see function 26) . All directory operations take place in 
a reserved area which does not affect write buffers as was the case in 
release 1, with the exception of Search First and Search Next, where 
compatibility is required. 

The File Control Block (FCB) data area consists of a sequence of 

33 bytes for sequential access and a series of 36 bytes in the case 

that the file is accessed randomly. The default file control block 

normally located at 005CH can be used for random access files, since 

the three bytes starting at BOOT+007DH are available- for this purpose. 
The FCB format is shown with the following fields: 
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|dr|fl|f2|/ / I f 8 I tl 1 12 1 13 I ex I si I s2 | r c I d0 I / /|dn|cr | r 0 | rl I r 2 I 
00 01 02 ... 08 09 10 11 12 13 14 15 16 ... 31 32 33 34 35 
where 

dr drive code (0 - 16) 

0 => use default drive for file 

1 => auto disk select drive A, 

2 => auto disk select drive B, 

• • • 

16=> auto disk select drive P. 

fl...f8 contain the file name in ASCII 
upper case, with high bit = 0 

tl,t2,t3 contain the file type in ASCII 
upper case, with high bit = 0 
tl*, t2', and t3' denote the 
bit of these positions, 
tl' = 1 => Read/Only file, 
t2' = 1 => SYS file, no DIR list 

ex contains the current extent number, 

normally set to 00 by the user, but 
in range 0 - 31 during file I/O 

si reserved for internal system use 

s2 reserved for internal system use, set 

to zero on call to OPEN, MAKE, SEARCH 

rc record count for extent "ex," 

takes on values from 0 - 128 

d0...dn filled-in by CP/M, reserved for 
system use 

cr current record to read or write in 

a sequential file operation, normally 
set to zero by user 

r0,rl,r2 optional random record number in the 
range 0-65535, with overflow to r2, 
r0,rl constitute a 16-bit value with 
low byte r0, and high byte rl 

Each file being accessed through CP/M must have a corresponding 
FCB which provides the name and allocation information for all 
subsequent file operations. When accessing files, it is the 
programmer's responsibility to fill the lower sixteen bytes of the FCB 
and initialize the "cr" field. Normally, bytes 1 through 11 are set 
to the ASCII character values for the file name and file type, while 
all other fields are zero. 
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FCB's are stored in a directory area of the disk, and are 
brought into central memory before proceeding with file operations 
(see the OPEN and MAKE functions) . The memory copy of the FCB is 
updated as file operations take place and later recorded permanently 
on disk at the termination of the file operation (see the CLOSE 
command) . 

The CCP constructs the first sixteen bytes of two optional FCB's 
for a transient by scanning the remainder of the line following the 
transient name, denoted by "filel" and "file2" in the prototype 
command line described above, with unspecified fields set to ASCII 
blanks. The first FCB is constructed at location BOOT+005CH, and can 
be used as-is for subsequent file operations. The second FCB occupies 
the d0 ... dn portion of the first FCB, and must be moved to another 
area of memory before use. If, for example, the operator types 

PROGNAME BiX.ZOT Y.ZAP 



the file PR0GNAME.COM is loaded into the TPA, and the default FCB at 
BOOT+005CH is initialized to drive code 2, file name "X" and file type 
"ZOT". The second drive code takes the default value 0, which is 
placed at BOOT+006CH, with the file name " Y" placed into location 
BOOT+006DH and file type "ZAP" located 8 bytes later at BOOT+0075H. 
All remaining fields through "cr" are set to zero. Note again that it 
is the programmer's responsibility to move this second file name and 
type to another area, usually a separate file control block, before 
opening the file which begins at BOOT+005CH, due to the fact that the 
open operation will overwrite the second name and type. 

If no file names are specified in the original command, then the 
fields beginning at BOOT+005DH and BOOT+006DH contain blanks. In all 
cases, the CCP translates lower case alphabetics to upper case to be 
consistent with the CP/M file naming conventions. 

As an added convenience, the default buffer area at location 
BOOT+0080H is initialized to the command line tail typed by the 
operator following the program name. The first position contains the 
number of characters, with the characters themselves following the 
character count. Given the above command line, the area beginning at 
BOOT+0080H is initialized as follows: 

BOOT+0 080H: 

+00 +01 +02 +03 +04 +05 +06 +07 +08 +09 +10 +11 +12 +13 +14 
^ •• ■■ » g it H v ii H ^ M ii it M g m "q •< it <j» ii ii !• ■» y it ii ii ii ^ 11 " ■* p ii 

where the characters are translated to upper case ASCII with 
uninitialized memory following the last valid character. Again, it is 
the responsibility of the programmer to extract the information from 
this buffer before any file operations are performed, unless the 
default DMA address is explicitly changed. 

The individual functions are described in detail in the pages 
which follow. 
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*************************************** 

* * 

* FUNCTION 0: System Reset * 

* * 

*************************************** 

* Entry Parameters: * 

* Register C: 00H * 
*************************************** 



The system reset function returns control to the CP/M operating 
system at the CCP level. The CCP re-initializes the disk subsystem by 
selecting and logging-in disk drive A. This function has exactly the 
same effect as a jump to location BOOT. 



*************************************** 

* * 

* FUNCTION 1: CONSOLE INPUT * 

* * 
*************************************** 

* Entry Parameters: * 

* Register C: 01H * 

* * 

* Returned Value: * 

* Register A: ASCII Character * 
*************************************** 



The console input function reads the next console character to 
register A. Graphic characters, along with carriage return, line 
feed, and backspace (ctl-H) are echoed to the console. Tab characters 
(ctl-I) are expanded in columns of eight characters. A check is made 
for start/stop scroll (ctl-S) and start/stop printer echo (ctl-P) . 
The FDOS does not return to the calling program until a character has 
been typed, thus suspending execution if a character is not ready. 



*************************************** 

* * 

* FUNCTION 2: CONSOLE OUTPUT * 

* * 

*************************************** 

* Entry Parameters: * 

* Register C: 02H * 

* Register E: ASCII Character * 

* * 

*************************************** 



The ASCII character from register E is sent to the console 
device. Similar to function 1, tabs are expanded and checks are made 
for start/stop scroll and printer echo. 
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*************************************** 

* * 

* FUNCTION 3: READER INPUT * 

* * 

*************************************** 

* Entry Parameters: * 

* Register C: 03H * 

* * 

* Returned Value: * 

* Register A: ASCII Character * 
*************************************** 



The Reader Input function reads the next character from the 
logical reader into register A (see the IOBYTE definition in the "CP/M 
Alteration Guide"). Control does not return until the character has 
been read. 



*************************************** 

* * 

* FUNCTION 4: PUNCH OUTPUT * 

* * 

*************************************** 

* Entry Parameters: * 

* Register C: 04H * 

* Register E: ASCII Character * 

* * 

*************************************** 



The Punch Output function sends the character from register E to 
the logical punch device. 



*************************************** 

* * 

* FUNCTION 5: LIST OUTPUT * 

* * 

*************************************** 

* Entry Parameters: * 

* Register C: 05H * 

* Register E: ASCII Character * 

* * 

*************************************** 



The List Output function sends the ASCII character in register E 
to the logical listing device. 
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*************************************** 

* * 

* FUNCTION 6: DIRECT CONSOLE I/O * 

* * 

*************************************** 



* 
* 
* 
* 
* 
* 
* 



Entry Parameters: 
Register C: 
Register E: 

Returned Value: 
Register A: 



06H 

0FFH (input) or 
char (output) 



char or status 
(no value) 



* 
* 
* 
* 
* 
* 

* 
* 



*************************************** 



Direct console I/O is supported under CP/M for those specialized 
applications where unadorned console input and output is required. 
Use of this function should, in general, be avoided since it bypasses 
all of CP/M's normal control character functions (e.g., control-S and 
control-P) . Programs which perform direct I/O through the BIOS under 
previous releases of CP/M, however, should be changed to use direct 
I/O under BDOS so that they can be fully supported under future 
releases of MP/M and CP/M. 

Upon entry to function 6, register E either contains hexadecimal 
FF, denoting a console input request, or register E contains an ASCII 
character. If the input value is FF, then function 6 returns A = 00 
if no character is ready, otherwise A contains the next console input 
character. 

If the input value in E is not FF, then function 6 assumes that 
E contains a valid ASCII character which is sent to the console. 
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*************************************** 

* * 

* FUNCTION 7: GET I/O BYTE * 

* * 

*************************************** 

* Entry Parameters: * 

* Register C: 07H * 

* * 

* Returned Value: * 

* Register A: I/O Byte Value * 
*************************************** 

The Get I/O Byte function returns the current value of IOBYTE in 
register A. See the "CP/M Alteration Guide" for IOBYTE definition. 



*************************************** 

* * 

* FUNCTION 8: SET I/O BYTE * 

* * 

*************************************** 

* Entry Parameters: * 

* Register C: 08H * 

* Register E: I/O Byte Value * 

* * 
*************************************** 



The Set I/O Byte function changes the system IOBYTE value to 
that given in register E. 



*************************************** 

* * 

* FUNCTION 9: PRINT STRING * 

* * 

*************************************** 

* Entry Parameters: * 

* Register C: 09H * 

* Registers DE: String Address * 

* * 

*************************************** 



The Print String function sends the character string stored in 

memory at the location given by DE to the console device, until a "$" 

is encountered in the string. Tabs are expanded as in function 2, and 
checks are made for start/stop scroll and printer echo. 
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*************************************** 

* * 

* FUNCTION 10: READ CONSOLE BUFFER * 

* * 
*************************************** 

* Entry Parameters: * 

* Register C: 0 AH * 

* Registers DE: Buffer Address * 

* * 

* Returned Value: * 

* Console Characters in Buffer * 
*************************************** 



The Read Buffer function reads a line of edited console input 
into a buffer addressed by registers DE. Console input is terminated 
when either the input buffer overflows. The Read Buffer takes the 
form: 

DE: +0 +1 + 2 +3 +4 +5 +6+7+8 ... +n 



Imx|nc|cl|c2|c3|c4|c5|c6|c7| . . . |??| 



where "mx" is the maximum number of characters which the buffer will 
hold (1 to 255) , "nc" is the number of characters read (set by FDOS 
upon return) , followed by the characters read from the console. if nc 
< mx, then uninitialized positions follow the last character, denoted 
by "??" in the above figure. A number of control functions are 
recognized during line editing: 

rub/del removes and echoes the last character 

ctl-C reboots when at the beginning of line 

ctl-E causes physical end of line 

ctl-H backspaces one character position 

ctl-J (line feed) terminates input line 

ctl-M (return) terminates input line 

ctl-R retypes the current line after new line 

ctl-u removes currnt line after new line 

ctl-x backspaces to beginning of current line 



Note also that certain functions which return the carriage to the 
leftmost position (e.g., ctl-X) do so only to the column position 
where the prompt ended (in earlier releases, the carriage returned to 
the extreme left margin). This convention makes operator data input 
and line correction more legible. 
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*************************************** 

* * 

* FUNCTION 11: GET CONSOLE STATUS * 

* * 
*************************************** 

* Entry Parameters: * 

* Register C: 0BH * 

* * 

* Returned Value: * 

* Register A: Console Status * 
*************************************** 



The Console Status function checks to see if a character has 
been typed at the console. If a character is ready, the value 0FFH is 
returned in register A. Otherwise a 00H value is returned. 



*************************************** 

* * 

* FUNCTION 12: RETURN VERSION NUMBER * 

* * 

*************************************** 

* Entry Parameters: * 

* Register C: 0CH * 

* * 

* Returned Value: * 

* Registers HL: Version Number * 
*************************************** 



Function 12 provides information which allows version 
independent programming. A two-byte value is returned, with H = 00 
designating the CP/M release (H = 01 for MP/M) , and L = 00 for all 
releases previous to 2.0. CP/M 2.0 returns a hexadecimal 20 in 
register L, with subsequent version 2 releases in the hexadecimal 
range 21, 22, through 2F. Using function 12, for example, you can 
write application programs which provide both sequential and random 
access functions, with random access disabled when operating under 
early releases of CP/M. 
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*************************************** 

* * 

* FUNCTION 13: RESET DISK SYSTEM * 

* * 
*************************************** 

* Entry Parameters: * 

* Register C: 0DH * 

* * 

*************************************** 

The Reset Disk Function is used to programmat ically restore the 
file system to a reset state where all disks are set to read/write 
(see functions 28 and 29) , only disk drive A is selected, and the 
default DMA address is reset to BOOT+0080H. This function can be 
used, for example, by an application program which requires a disk 
change without a system reboot. 



*************************************** 

* * 

* FUNCTION 14: SELECT DISK * 

* * 

*************************************** 

* Entry Parameters: * 

* Register C: 0 EH * 

* Register E: Selected Disk * 

* * 

*************************************** 



The Select Disk function designates the disk drive named in 
register E as the default disk for subsequent file operations, with E 
= 0 for drive A, 1 for drive B, and so-forth through 15 corresponding 
to drive P in a full sixteen drive system. The drive is placed in an 
"on-line" status which, in particular, activates its directory until 
the next cold start, warm start, or disk system reset operation. If 
the disk media is changed while it is on-line, the drive automatically 
goes to a read/only status in a standard CP/M environment (see 
function 28). FCB's which specify drive code zero (dr = 00H) 
automatically reference the currently selected default drive. Drive 
code values between 1 and 16, however, ignore the selected default 
drive and directly reference drives A through P. 
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*************************************** 

* * 

* FUNCTION 15: OPEN FILE * 

* * 

*************************************** 

* Entry Parameters: * 

* Register C: 0 FH * 
Registers DE: FCB Address * 



* Returned Value: * 

* Register A: Directory Code * 
*************************************** 



The Open File operation is used to activate a file which 
currently exists in the disk directory for the currently active user 
number. The FDOS scans the referenced disk directory for a match in 
positions 1 through 14 of the FCB referenced by DE (byte si is 
automatically zeroed), where an ASCII question mark (3FH) matches any 
directory character in any of these positions. Normally, no question 
marks are included and, further, bytes "ex" and "s2" of the FCB are 
zero. 

If a directory element is matched, the relevant directory 
information is copied into bytes d0 through dn of the FCB, thus 
allowing access to the files through subsequent read and write 
operations. Note that an existing file must not be accessed until a 
sucessful open operation is completed. Upon return, the open function 
returns a "directory code" with the value 0 through 3 if the open was 
successful, or 0FFH (255 decimal) if the file cannot be found. If 
question marks occur in the FCB then the first matching FCB is 
activated. Note that the current record ("cr") must be zeroed by the 
program if the file is to be accessed sequentially from the first 
record. 
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*************************************** 

* * 

* FUNCTION 16: CLOSE FILE * 

* * 

*************************************** 

* Entry Parameters: * 

* Register C: 10H * 

* Registers DE: FCB Address * 

* * 

* Returned Value: * 

* Register A: Directory Code * 
*************************************** 

The Close File function performs the inverse of the open file 
function. Given that the FCB addressed by DE has been previously 
activated through an open or make function (see functions 15 and 22), 
the close function permanently records the new FCB in the referenced 
disk directory. The FCB matching process for the close is identical 
to the open function. The directory code returned for a successful 
close operation is 0, 1, 2, or 3, while a 0FFH (255 decimal) is 
returned if the file name cannot be found in the directory. A file 
need not be closed if only read operations have taken place. If write 
operations have occurred, however, the close operation is necessary to 
permanently record the new directory information. 
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*************************************** 

* * 

* FUNCTION 17: SEARCH FOR FIRST * 

* * 

*************************************** 



* 
* 
* 

* 
* 



Entry Parameters: 
Register C: 
Registers DE: 

Returned Value: 
Register A: 



11H 

FCB Address 



Directory Code 



* 
* 

* 
* 
* 
* 



*************************************** 



Search First scans the directory for a match with the file given 
by the FCB addressed by DE. The value 255 (hexadecimal FF) is 
returned if the file is not found, otherwise 0, 1, 2, or 3 is returned 
indicating the file is present. In the case that the file is found, 
the current DMA address is filled with the record containing the 
directory entry, and the relative starting position is A * 32 (i.e., 
rotate the A register left 5 bits, or ADD A five times). Although not 
normally required for application programs, the directory information 
can be extracted from the buffer at this position. 

An ASCII question mark (63 decimal, 3F hexadecimal) in any 
position from "fl" through "ex" matches the corresponding field of any 
directory entry on the default or auto-selected disk drive. If the 
"dr" field contains an ASCII question mark, then the auto disk select 
function is disabled, the default disk is searched, with the search 
function returning any matched entry, allocated or free, belonging to 
any user number. This latter function is not normally used by 
application programs, but does allow complete flexibility to scan all 
current directory values. If the "dr" field is not a question mark, 
the "s2" byte is automatically zeroed. 



*************************************** 

* * 

* FUNCTION 18: SEARCH FOR NEXT * 

* * 

*************************************** 

* Entry Parameters: * 

* Register C: 12H * 

* Returned Value: * 

* Register A: Directory Code * 
*************************************** 



The Search Next function is similar to the Search First 
function, except that the directory scan continues from the last 
matched entry. Similar to function 17, function 18 returns the 
decimal value 255 in A when no more directory items match. 
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*************************************** 

* * 

* FUNCTION 19: DELETE FILE * 



*************************************** 

* Entry Parameters: * 

* Register C: 13H * 

* Registers DE: FCB Address * 

* * 

* Returned Value: * 

* Register A: Directory Code * 
*************************************** 

The Delete File function removes files which match the FCB 

addressed by DE. The filename and type may contain ambiguous 
references (i.e., question marks in various positions), but the drive 

select code cannot be ambiguous, as in the Search and Search Next 
functions. 

Function 19 returns a decimal 255 if the referenced file or 

files cannot be found, otherwise a value in the range 0 to 3 is 
returned. 



*************************************** 

* * 

* FUNCTION 20: READ SEQUENTIAL * 

* * 

*************************************** 



* Entry Parameters: 

* Register C: 

* Registers DE: 
* 

* Returned Value: 

* Register A: 



14H 

FCB Address 



* 
* 
* 
* 



Directory Code * 
*************************************** 



Given that the FCB addressed by DE has been activated through an 
open or make function (numbers 15 and 22) , the Read Sequential 
function reads the next 128 byte record from the file into memory at 
the current DMA address. the record is read from position "cr" of the 
extent, and the "cr" field is automatically incremented to the next 
record position. If the "cr" field overflows then the next logical 
extent is automatically opened and the "cr" field is reset to zero in 
preparation for the next read operation. The value 00H is returned in 
the A register if the read operation was successful, while a non-zero 
value is returned if no data exists at the next record position (e.g. , 
end of file occurs). 
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*************************************** 

* * 



* 
* 



FUNCTION 21: WRITE SEQUENTIAL 



* 
* 



*************************************** 



15H 

FCB Address 



* 
* 
* 
* 
* 

Directory Code * 
*************************************** 



* Entry Parameters: 

* Register C: 

* Registers DE: 
* 

* Returned Value: 

* Register A: 



Given that the FCb addressed by DE has been activated through an 
open or make function (numbers 15 and 22), the Write Sequential 
function writes the 128 byte data record at the current DMA address to 
the file named by the FCB. the record is placed at position "cr" of 
the file, and the "cr" field is automatically incremented to the next 
record position. If the "cr" field overflows then the next logical 
extent is automatically opened and the "cr" field is reset to zero in 
preparation for the next write operation. Write operations can take 
place into an existing file, in which case newly written records 
overlay those which already exist in the file. Register A = 00H upon 
return from a successful write operation, while a non-zero value 
indicates an unsuccessful write due to a full disk. 



*************************************** 

* * 

* FUNCTION 22: MAKE FILE * 

* * 
*************************************** 

* Entry Parameters: * 

* Register C: 16H * 

* Registers DE: FCB Address * 



* Returned value: * 

* Register A: Directory Code * 
*************************************** 



The Make File operation is similar to the open file operation 
except that the FCB must name a file which does not exist in the 
currently referenced disk directory (i.e. , the one named explicitly by 
a non-zero "dr" code, or the default disk if "dr" is zero). The FDOS 
creates the file and initializes both the directory and main memory 
value to an empty file. The programmer must ensure that no duplicate 
file names occur, and a preceding delete operation is sufficient if 
there is any possibility of duplication. Upon return, register A = 0, 
1, 2, or 3 if the operation was successful and 0FFH (255 decimal) if 
no more directory space is available. The make function has the 
side-effect of activating the FCB and thus a subsequent open is not 
necessary . 
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*************************************** 

* * 

* FUNCTION 23: RENAME FILE * 

* * 

*************************************** 

* 
* 
* 
* 
* 

Directory Code * 
*************************************** 



* Entry Parameters: 

* Register C: 

* Registers DE: 
* 

* Returned Value: 

* Register A: 



17H 

FCB Address 



The Rename function uses the FCB addressed by DE to change all 
occurrences of the file named in the first 16 bytes to the file named 
in the second 16 bytes. The drive code "dr" at position 0 is used to 
select the drive, while the drive code for the new file name at 
position 16 of the FCB is assumed to be zero. Upon return, register A 
is set to a value between 0 and 3 if the rename was successful, and 
0FFH (255 decimal) if the first file name could not be found in the 
directory scan. 



*************************************** 

* * 

* FUNCTION 24: RETURN LOGIN VECTOR * 

* * 

*************************************** 

* Entry Parameters: * 

* Register C: 18H * 

* * 

* Returned Value: * 

* Registers HL: Loqin Vector * 
*************************************** 



The login vector value returned by CP/M is a 16-bit value in HL, 
where the least significant bit of L corresponds to the first drive A, 
and the high order bit of H corresponds to the sixteenth drive, 
labelled P. A "0" bit indicates that the drive is not on-line, while 
a "1" bit marks an drive that is actively on-line due to an explicit 
disk drive selection, or an implicit drive select caused by a file 
operation which specified a non-zero "dr" field. Note that 
compatibility is maintained with earlier releases, since registers A 
and L contain the same values upon return. 
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*************************************** 

* * 

* FUNCTION 25: RETURN CURRENT DISK * 

* * 

*************************************** 

* Entry Parameters: * 

* Register C: 19H * 

* * 

* Returned Value: * 

* Register A: Current Disk * 
*************************************** 



Function 25 returns the currently selected default disk number 
in register A. The disk numbers range from 0 through 15 corresponding 
to drives A through P. 



*************************************** 

* * 

* FUNCTION 26: SET DMA ADDRESS * 

* * 

*************************************** 

* Entry Parameters: * 

* Register C: 1AH * 

* Registers DE: DMA Address * 

* * 
*************************************** 



"DMA" is an acronym for Direct Memory Address, which is often 
used in connection with disk controllers which directly access the 
memory of the mainframe computer to transfer data to and from the disk 
subsystem. Although many computer systems use non-DMA access (i.e., 
the data is transferred through programmed I/O operations) , the DMA 
address has, in CP/M, come to mean the address at which the 128 byte 
data record resides before a disk write and after a disk read. Upon 
cold start, warm start, or disk system reset, the DMA address is 
automatically set to BOOT+0080H. The Set DMA function, however, can 
be used to change this default value to address another area of memory 
where the data records reside. Thus, the DMA address becomes the 
value specified by DE until it is changed by a subsequent Set DMA 
function, cold start, warm start, or disk system reset. 
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*************************************** 

* * 

* FUNCTION 27: GET ADDR (ALLOC) * 

* * 
*************************************** 

* Entry Parameters: * 

* Register C: 1BH * 

* * 

* Returned Value: * 

* Registers HL: ALLOC Address * 
*************************************** 



An "allocation vector" is maintained in main memory for each 
on-line disk drive. Various system programs use the information 
provided by the allocation vector to determine the amount of remaining 
storage (see the STAT program) . Function 27 returns the base address 
of the allocation vector for the currently selected disk drive. The 
allocation information may, however, be invalid if the selected disk 
has been marked read/only. Although this function is not normally 
used by application programs, additional details of the allocation 
vector are found in the "CP/M Alteration Guide." 



*************************************** 

* * 

* FUNCTION 28: WRITE PROTECT DISK * 

* * 

*************************************** 

* Entry Parameters: * 

* Register C: 1CH * 

* * 

*************************************** 



The disk write protect function provides temporary write 
protection for the currently selected disk. Any attempt to write to 
the disk, before the next cold or warm start operation produces the 
message 

Bdos Err on d: R/O 
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*************************************** 

* * 

* FUNCTION 29: GET READ /ONLY VECTOR * 

* * 

*************************************** 

* Entry Parameters: * 

* Register C: 1DH * 

* * 

* Returned Value: * 

* Registers HL: R/O Vector Value* 
*************************************** 



Function 29 returns a bit vector in register pair HL which 
indicates drives which have the temporary read/only bit set. Similar 
to function 24, the least significant bit corresponds to drive A, 
while the most significant bit corresponds to drive P. The R/0 bit is 
set either by an explicit call to function 28, or by the automatic 
software mechanisms within CP/M which detect changed disks. 



*************************************** 

* * 

* FUNCTION 30: SET FILE ATTRIBUTES * 

* * 

*************************************** 



* Entry Parameters: 

* Register C: 
Registers DE : 



* 
* 
* 



Returned Value: 
Register A: 



1 EH 

FCB Address 



Directory Code 



* 
* 
* 
* 
* 
* 



*************************************** 



The Set File Attributes function allows programmatic 
manipulation of permanent indicators attached to files. In 
particular, the R/0 and System attributes (tl' and t2') can be set or 
reset. The DE pair addresses an unambiguous file name with the 
appropriate attributes set or reset. Function 30 searches for a 
match, and changes the matched directory entry to contain the selected 
indicators. Indicators fl* through f4* are not presently used, but 
may be useful for applications programs, since they are not involved 
in the matching process during file open and close operations. 
Indicators f5' through f8' and t3' are reserved for future system 
expansion. 
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*************************************** 

* * 

* FUNCTION 31: GET ADDR (DISK PARMS) * 

* * 

*************************************** 

* Entry Parameters: * 

* Register C: 1FH * 

* * 

* Returned Value: * 

* Registers HL: DPB Address * 
*************************************** 



The address of the BIOS resident disk parameter block is 
returned in HL as a result of this function call. This address can be 
used for either of two purposes. First, the disk parameter values can 
be extracted for display and space computation purposes, or transient 
programs can dynamically change the values of current disk parameters 
when the disk environment changes, if required. Normally, application 
programs will not require this facility. 



*************************************** 

* * 

* FUNCTION 3 2: SET/GET USER CODE * 

* * 

*************************************** 

* Entry Parameters: * 

* Register C: 20H * 

* Register E: 0FFH (get) or * 

* User Code (set) * 



* Returned Value: * 

* Register A: Current Code or * 

* (no value) * 
*************************************** 



An application program can change or interrogate the currently 
active user number by calling function 32. If register E = 0FFH, then 
the value of the current user number is returned in register A, where 
the value is in the range 0 to 31. If register E is not 0FFH, then 
the current user number is changed to the value of E (modulo 32). 
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*************************************** 

* * 

* FUNCTION 33: READ RANDOM * 

* * 

*************************************** 



* Entry Parameters: 

* Register C: 
* 

* 

* 

* 



Registers DE: 

Returned Value: 
Reqister A: 



21H 

FCB Address 



Return Code 



* 
* 
* 
* 
* 
* 



*************************************** 



The Read Random function is similar to the sequential file read 
operation of previous releases, except that the read operation takes 
place at a particular record number, selected by the 24-bit value 
constructed from the three byte field following the FCB (byte 
positions r0 at 33, rl at 34, and r2 at 35). Note that the sequence 
of 24 bits is stored with least significant byte first (r0) , middle 
byte next (rl) , and high byte last (r2) . CP/M does not reference byte 
r2, except in computing the size of a file (function 35). Byte r2 
must be zero, however, since a non-zero value indicates overflow past 
the end of file. 

Thus, the r0,rl byte pair is treated as a double-byte, or "word" 
value, which contains the record to read. This value ranges from 0 to 
65535, providing access to any particular record of the 8 megabyte 
file. In order to process a file using random access, the base extent 
(extent 0) must first be opened. Although the base extent may or may 
not contain any allocated data, this ensures that the file is properly 
recorded in the directory, and is visible in DIR requests. The 
selected record number is then stored into the random record field 
(r0,rl), and the BDOS is called to read the record. Upon return from 
the call, register A either contains an error code, as listed below, 
or the value 00 indicating the operation was successful. In the 
latter case, the current DMA address contains the randomly accessed 
record. Note that contrary to the sequential read operation, the 
record number is not advanced. Thus, subsequent random read 
operations continue to read the same record. 

Upon each random read operation, the logical extent and current 
record values are automatically set. Thus, the file can be 
sequentially read or written, starting from the current randomly 
accessed position. Note, however, that in this case, the last 
randomly read record will be re-read as you switch from random mode to 
sequential read, and the last record will be re-written as you switch 
to a sequential write operation. You can, of course, simply advance 
the random record position following each random read or write to 
obtain the effect of a sequential I/O operation. 

Error codes returned in register A following a random read are 
listed below. 
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01 
02 
03 
04 
05 
06 



reading unwritten data 
(not returned in random mode) 
cannot close current extent 
seek to unwritten extent 
(not returned in read mode) 
seek past physical end of disk 



Error code 01 and 04 occur when a random read operation accesses a 
data block which has not been previously written, or an extent which 
has not been created, which are equivalent conditions. Error 3 does 
not normally occur under proper system operation, but can be cleared 
by simply re-reading, or re-opening extent zero as long as the disk is 
not physically write protected. Error code 06 occurs whenever byte r2 
is non-zero under the current 2.0 release. Normally, non-zero return 
codes can be treated as missing data, with zero return codes 
indicating operation complete. 
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*************************************** 

* * 

* FUNCTION 34: WRITE RANDOM * 

* * 

*************************************** 



* Entry Parameters: 

* Register C: 

* Registers DE: 
* 

* 

* 



Returned Value: 
Register A: 



22H 

FCB Address 



Return Code 



* 
* 
* 
* 
* 
* 



*************************************** 



The Write Random operation is initiated similar to the Read 
Random call, except that data is written to the disk from the current 
DMA address. Further, if the disk extent or data block which is the 
target of the write has not yet been allocated, the allocation is 
performed before the write operation continues. As in the Read Random 
operation, the random record number is not changed as a result of the 
write. The logical extent number and current record positions of the 
file control block are set to correspond to the random record which is 
being written. Again, sequential read or write operations can 
commence following a random write, with the notation that the 
currently addressed record is either read or rewritten again as the 
sequential operation begins. You can also simply advance the random 
record position following each write to get the effect of a sequential 
write operation. Note that in particular, reading or writing the last 
record of an extent in random mode does not cause an automatic extent 
switch as it does in sequential mode. 

The error codes returned by a random write are identical to the 
random read operation with the addition of error code 05, which 
indicates that a new extent cannot be created due to directory 
overflow . 
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*************************************** 

* * 

* FUNCTION 35: COMPUTE FILE SIZE * 

* * 

*************************************** 

* Entry Parameters: * 

* Register C: 23H * 

* Registers DE: FCB Address * 

* * 

* Returned Value: * 

* Random Record Field Set * 
*************************************** 



When computing the size of a file, the DE register pair 
addresses an FCB in random mode format (bytes r0, rl, and r2 are 
present). The FCB contains an unambiguous file name which is used in 
the directory scan. Upon return, the random record bytes contain the 
"virtual" file size which is, in effect, the record address of the 
record following the end of the file. if, following a call to 
function 35, the high record byte r2 is 01, then the file contains the 
maximum record count 65536. Otherwise, bytes r0 and rl constitute a 
16-bit value (r0 is the least significant byte, as before) which is 
the file size. 

Data can be appended to the end of an existing file by simply 
calling function 35 to set the random record position to the end of 
file, then performing a sequence of random writes starting at the 
preset record address. 

The virtual size of a file corresponds to the physical size when 
the file is written sequentially. If, instead, the file was created 
in random mode and "holes" exist in the allocation, then the file may 
in fact contain fewer records than the size indicates. If, for 
example, onlv the last record of an eight megabyte file is written in 
random mode (i.e., record number 65535), then the virtual size is 
65536 records, although only one block of data is actually allocated. 
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*************************************** 

* * 

* FUNCTION 36: SET RANDOM RECORD * 

* * 
*************************************** 

* Entry Parameters: * 

* Register C: 24H * 

* Registers DE: FCB Address * 

* * 

* Returned Value: * 

* Random Record Field Set * 
*************************************** 



The Set Random Record function causes the BDOS to automatically 
produce the random record position from a file which has been read or 
written sequentially to a particular point. The function can be 
useful in two ways. 

First, it is often necessary to initially read and scan a 
sequential file to extract the positions of various "key" fields. As 
each key is encountered, function 36 is called to compute the random 
record position for the data corresponding to this key. If the data 
unit size is 128 bytes, the resulting record position is placed into a 
table with the key for later retrieval. After scanning the entire 
file and tabularizing the keys and their record numbers, you can move 
instantly to a particular keyed record by performing a random read 
using the corresponding random record number which was saved earlier. 
The scheme is easily generalized when variable record lengths are 
involved since the program need only store the buffer-relative byte 
position along with the key and record number in order to find the 
exact starting position of the keyed data at a later time. 

A second use of function 36 occurs when switching from a 
sequential read or write over to random read or write. A file is 
sequentially accessed to a particular point in the file, function 36 
is called which sets the record number, and subsequent random read and 
write operations continue from the selected point in the file. 
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3. A SAMPLE FILE-TO-FILE COPY PROGRAM. 

The program shown below provides a relatively simple example of 
file operations. The program source file is created as COPY. ASM using 
the CP/M ED program and then assembled using ASM or MAC, resulting in 
a "HEX" file. The LOAD program is the used to produce a COPY.COM file 
which executes directly under the CCP. The program begins by setting 
the stack pointer to a local area, and then proceeds to move the 
second name from the default area at 006CH to a 33-byte file control 
block called DFCB. The DFCB is then prepared for file operations by 
clearing the current record field. At this point, the source and 
destination FCB's are ready for processing since the SFCB at 005CH is 
properly set-up by the CCP upon entry to the COPY program. That is, 
the first name is placed into the default fcb, with the proper fields 
zeroed, including the current record field at 007CH. The program 
continues by opening the source file, deleting any exising destination 
file, and then creating the destination file. If all this is 
successful, the program loops at the label COPY until each record has 
been read from the source file and placed into the destination file. 
Upon completion of the data transfer, the destination file is closed 
and the program returns to the CCP command level by jumping to BOOT. 



sample file-to-file copy program 
at the ccp level, the command 
copy a:x.y b:u.v 



copies the file named x.y from drive 
a to a file named u.v on drive b. 



0000 




boot 


equ 


0 0 0 0h 


system reboot 


0005 




bdos 


equ 


0 0 0 5h ; 


bdos entry point 


0 0 5c 




fcbl 


equ 


0 0 5ch 


first file name 


0 0 5c 




sfcb 


equ 


fcbl 


source fcb 


006c 




fcb2 


equ 


0 0 6ch 


second file name 


0080 




dbuf f 


equ 


0 0 80h 


default buffer 


0100 




tpa 


equ 


0100h ; 


beginning of tpa 


0009 




pr intf 


equ 


9 ; 


print buffer func# 


0 0 0f 




openf 


equ 


15 


open file func# 


0010 




closef 


equ 


16 ; 


close file func# 


0013 




deletef 


equ 


19 ; 


delete file func# 


0014 




readf 


equ 


20 ; 


sequential read 


0015 




wr i tef 


equ 


21 


sequential write 


0016 




makef 
. 


equ 


2 2 


make file func# 


0100 






org 


tpa ; 


beginning of tpa 


0100 


311b02 


. 


lxi 


sp, stack ; 


local stack 








move 


second file 


name to dfcb 


0103 


0el0 




mvi 


c , 1 6 


half an fcb 



(All Information Contained Herein is Proprietary to Digital Research.) 

30 



0105 


116c00 




lxi 


d,fcb2 ; 


source of move 


0108 


21da01 




lxi 


h,dfcb 


destination fcb 


010b 


la 


mf cb: 


ldax 


d ! 


source fcb 


010c 


13 




inx 


d ; 


ready next 


010d 


77 




mov 


m ,a i 


dest fcb 


0 10e 


23 




i nx 


h ; 


readv next 


0l0f 


0d 




dcr 


c ; 


count 16. . .0 


0110 


c20b01 




jnz 


mf cb 


loop 16 times 






• 


1 1 QUI " 


has been moved, zero cr 


0113 


af 




xr a 


a ; a = 00h 


V -L X *4 






sta 


dfcbcr ; current rec = 0 






. 

; 


source and destination fcb's read; 


0117 


115C00 


; 


lxi 


d , sf cb 


; source file 


011a 


cd6901 




call 


open 


; error if 255 


011d 


118701 




lxi 


d ,nof ile 


; ready message 


0120 


3c 




inr 


a 


; 255 becomes 0 


0121 


cc6101 




cz 


finis 


; done if no file 



0124 llda01 
0127 cd7301 

012a llda01 
012d cd8201 
0130 119601 

0133 3c 

0134 CC6101 



013 7 115c0 0 copy: 
013a cd7801 
013d b7 
013e C25101 



source file open, prep destination 

lxi d,dfcb ; destination 

call delete ; remove if present 



lxi 

call 

lxi 

inr 

cz 



d,dfcb 
make 
d ,nodir 
a 

finis 



destination 

create the file 

ready message 

255 becomes 0 

done if no dir space 



source file open, dest file open 
copy until end of file on source 



lxi 
call 

ora 
jnz 



d ,sfcb 

read 

a 

eof ile 



source 

read next record 

end of file? 
skip wr i te if so 



0141 llda01 

0144 cd7d01 

0147 lla901 

014a b7 

014b C46101 

014e C33701 



0151 llda01 

0154 cd6e01 

0157 21bb01 

015a 3c 

015b cc6101 



not 

lxi 

call 

lxi 

ora 

cnz 

jmp 



end 



of file, 
d,dfcb 
wr i te 
d , space 
a 

finis 
copy 



write the record 
destination 
write record 
ready message 
00 if write ok 
end if so 
loop until eof 



eof ile: 



end of file, close destination 



lxi 

call 

lxi 

inr 

cz 



d,df cb 
close 
h ,wrprot 
a 

finis 



destination 
255 if error 
ready message 
255 becomes 00 
shouldn't happen 



copy operation complete, end 
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015e 


11CC01 




lxi 




d, normal; ready message 






• 

finis: 


; write 


message given by de, reboot 




(h £a (A Q 




mvi 




r* nr i nf f 
\, p yj L J.UV-JL 


0163 


cd0500 




call 




bdos ; write message 


0166 


C30000 




jmp 




boot ; reboot system 






[ 


system interface subroutines 








(all 


return directly from bdos) 


0169 


0e0f 


open: 


mvi 




\, 9 11 i. 


016b 


C30500 




jmp 




bdos 


016e 


0el0 


i 

close: 


ill V X 




r* c*~\ oc af 


0170 


C30500 




j m P 




bdos 


0173 


0el3 


delete: 


mvi 




c , aeie ter 


0175 


C30500 




jmp 




bdos 


0178 


0el4 


• 

read : 


mvi 




c , r e ad f 


017a 


C30500 




jmp 




bdos 


017d 


0el5 


wr i te: 


mvi 




c,wr itef 


017f 


C30500 




jmp 




bdos 


0182 


0el6 


7 

make : 


mvi 




c ,make f 


0184 


C30500 




jmp 




bdos 






• 
• 


console 


messages 


0187 


6e6f 20f nof ile: 


db 




'no source file$' 


0196 


6e6f 209nodir: 


db 




'no directory space$ ' 


v lay 


6f 7574f space: 


db 




'out of data space$' 


01bb 


7772695wrprot: 


db 




'write protected?$' 


0 lCC 


636f 700normal : 

• 


db 




' copy complete$ 1 








data 


areas 


01da 




dfcb: 


ds 




33 ; destination fcb 


01fa 




df cbcr 
• 


equ 




dfcb+32 ; current record 


01fb 






ds 




32 ; 16 level stack 






stack : 








021b 






end 







Note that there are several simplifications in this particular 
program. First, there are no checks for invalid file names which 
could, for example, contain ambiguous references. This situation 
could be detected by scanning the 32 byte default area starting at 
location 005CH for ASCII question marks. A check should also be made 
to ensure that the file names have, in fact, been included (check 
locations 005DH and 006DH for non-blank ASCII characters). Finally, a 
check should be made to ensure that the source and destination file 
names are different. A speed improvement could be made by buffering 
more data on each read operation. One could, for example, determine 
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the size of memory by fetching FBASE from location 0006H and use the 
entire remaining portion of memory for a data buffer. In this case, 
the programmer simply resets the DMA address to the next successive 
128 byte area before each read. Upon writing to the destination file, 
the DMA address is reset to the beginning of the buffer and 
incremented by 128 bytes to the end as each record is transferred to 
the destination file. 
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4. A SAMPLE FILE DUMP UTILITY. 



The file dump program shown below is slightly more complex than 
the simple copy program given in the previous section. The dump 
program reads an input file, specified in the CCP command line, and 
displays the content of each record in hexadecimal format at the 
console. Note that the dump program saves the CCP's stack upon entry, 
resets the stack to a local area, and restores the CCP's stack before 
returning directly to the CCP. Thus, the dump program does not 
perform and warm start at the end of processing. 

; DUMP program reads input file and displays hex data 



0100 






org 


100h 


0005 




bdos 


equ 


0 0 05h 


0001 




cons 


equ 


1 


0002 




typef 


equ 


2 


0009 




pr mtf 


equ 


9 


000b 




brkf 


equ 


11 


000f 




openf 


equ 


15 


0014 




readf 


equ 


20 


0 0 5c 




fcb 


equ 


5ch 


0080 




buff 
• 


equ 


80h 






• 


non 


graphic c 


0 00d 




cr 


equ 


0dh 


0 00a 




If 


equ 


0ah 



;dos entry point 
;read console 
; type function 
;buffer print entry 

;break key function (true if char 
;file open 

;read function 

;file control block address 
;input disk buffer address 



;carriage return 
;line feed 



005c 




f cbdn 


equ 


fcb+0 


0 05d 




fcbfn 


equ 


fcb+1 


0065 




fcbf t 


equ 


fcb+9 


0068 




fcbrl 


equ 


fcb+1 2 


0 06b 




f cbrc 


equ 


fcb+1 5 


007c 




f cbcr 


equ 


fcb+3 2 


007d 




fcbln 
• 


equ 


fcb+33 






i 
• 


set up 


stack 


0100 


210000 




lxi 


h,0 


0103 


39 




dad 


sp 



file control block definitions 

;disk name 
;file name 

;disk file type (3 characters) 
;file's current reel number 
;file's record count (0 to 128) 
;current (next) record number (0 
;fcb length 



0104 221502 
0107 315702 

010a cdcl01 
010d feff 
010f c21b01 



0112 llf301 
0115 cd9c01 
0118 C35101 



shld oldsp 

set sp to local stack area (restored at finis) 

lxi sp,stktop 

read and print successive buffers 

call setup ;set up input file 

cpi 255 ;255 if file not present 

jnz openok ;skip if open is ok 

file not there, give error message and return 

lxi d,opnmsg 
err 
finis 



call 
jmp 



;to return 
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open ok : 

011b 3e80 
01 Id 321302 



0120 210000 

7 

gloop: 

0123 e5 

0124 cda201 

0127 el 

0128 da5101 
012b 47 



012c 7d 
012d e60f 
012f C24401 

0132 cd7201 



0135 cd5901 

0138 0f 

0139 da5101 

• 

013c 7c 
013d cd8f01 

0140 7d 

0141 cd8f01 

nonum: 

0144 23 

0145 3e20 
0147 cd6501 
014a 7 8 
014b cd8f01 
014e C32301 

J 

finis: 



0151 cd7201 
0154 2al502 

0157 f9 

0158 c9 



break: 

0159 e5d5c5 
015c 0e0b 
015e cd0500 
0161 cldlel 



;open operation ok, set buffer index to end 
mvi a,8 0h 

sta ibp ;set buffer pointer to 80h 

hi contains next address to print 



lxi 


h, 0 


• i • , » fx ft f\ fx 

; start with 0000 


push 


h 


;save line position 


call 


gnb 




pop 


h 


;recall line position 


jc 


finis 


;carry set by gnb if end 


mov 


b,a 




pr i nt 


hex values 


check 


for line fold 


mov 


a,l 




ani 


0fh 


;check low 4 bits 


jnz 


nonum 




pr int 


line number 


call 


crlf 




check 


for break 


key 


call 


break 




accum 


lsb = 1 if 


character ready 


r r c 




;into carry 


jc 


finis 


;don't print any more 


mov 


a,h 




call 


phex 




mov 


a,l 




call 


phex 




inx 


h 


; to next line number 


mvi 


a,' ' 




call 


pchar 




mov 


a , b 




call 


phex 




jmp 


gloop 





end of dump, return to ccp 

(note that a jmp to 0000h reboots) 

call crlf 

lhld oldsp 

sphl 

stack pointer contains ccp's stack location 
ret ;to the ccp 

subroutines 

;check break key (actually any key will do) 
push h! push d! push b; environment saved 
mvi c,brkf 
call bdos 

pop b! pop d! pop h; environment restored 
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0164 c9 



ret 



pchar : 

0165 e5d5c5 
0168 0e02 
016a 5f 
016b cd0500 
016e cldlel 

0171 c9 

• 

crlf : 

0172 3e0d 
0174 cd6501 
0177 3e0a 
0179 cd6501 
017c c9 



pnib: 

017d e60f 
017f fe0a 
0181 d28901 

0184 c630 
0186 c38b01 



0189 c637 pl0: 
018b cd6501 prn: 
018e c9 

phex : 

018f f5 

0190 0f 

0191 0f 

0192 0f 

0193 0f 

0194 Cd7d01 

0197 fl 

0198 Cd7d01 
019b c9 

err: 

019c 0e09 
019e cd0500 
01al c9 



gnb: 

01a2 3al302 
01a5 fe80 
01a7 c2b301 



;print a character 

push hi push di push b; saved 

mvi c,typef 

mov e r a 

call bdos 

pop b! pop d! pop h; restored 
ret 



mvi a,cr 

call pchar 

mvi a, If 

call pchar 
ret 



;print nibble in reg a 
ani 0fh ;low 4 bits 

cpi 10 
jnc pl0 

less than or equal to 9 
adi '0' 
jmp prn 

greater or equal to 10 
adi *a' - 10 

call pchar 
ret 

;print hex char in reg a 

push psw 

r rc 

r rc 

rrc 

rrc 

call pnib ;print nibble 
pop psw 
call pnib 
ret 

;print error message 

d,e addresses message ending with "$" 

mvi cprintf ;print buffer function 

call bdos 

ret 



;get next byte 

Ida ibp 

cpi 80h 

jnz g0 

read another buffer 
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01aa cdce01 
01ad b7 
01ae cab301 

01bl 3 7 
01b2 c9 

• 

g0 : 

01b3 5f 
01b4 1600 
01b6 3c 
01b7 321302 



01ba 218000 
01bd 19 

01be 7e 

01bf b7 
01c0 c9 

setup: 

01cl af 
01c2 327c00 

• 

01c5 115C00 
01c8 0e0f 
0 lea cd0500 

• 

f 

01cd c9 

diskr : 

01ce e5d5c5 
01dl 115c00 
01d4 0el4 
01d6 cd0500 
01d9 cldlel 
01dc c9 



01dd 46494c0signon: 
01f3 0d0a4e0opnmsg : 



0213 ibp: 
0215 oldsp: 



0217 

stktop: 

a 

0257 



call diskr 

ora a ;zero value if read ok 

jz g0 ;for another byte 

end of data, return with carry set for eof 

stc 

ret 

;read the byte at buff+reg a 

mov e,a ;ls byte of buffer index 

mvi d,0 ;double precision index to de 

inr a ; index=index+l 

sta ibp ;back to memory 

pointer is incremented 

save the current file address 

lxi h,buff 
dad d 

absolute character address is in hi 
mov a , m 

byte is in the accumulator 

ora a ;reset carry bit 

ret 

;set up file 

open the file for input 

xra a ;zero to accum 

sta feber ;clear current record 

lxi d,fcb 
mvi c,openf 
call bdos 

255 in accum if open error 
ret 



;read disk file record 

push h! push d! push b 

lxi d,fcb 

mvi c,readf 

call bdos 

pop b! pop d! pop h 

ret 



fixed message area 

db 'file dump version 2.0$' 

db cr,lf,'no input file present on disk$' 

variable area 

ds 2 ; input buffer pointer 

ds 2 ; entry sp value from ccp 

stack area 

ds 64 ; reserve 32 level stack 



end 
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5. A SAMPLE RANDOM ACCESS PROGRAM. 



This manual is concluded with a rather extensive, but complete 
example of random access operation. The program listed below performs 
the simple function of reading or writing random records upon command 
from the terminal. Given that the program has been created, 
assembled, and placed into a file labelled RAND0M.COM, the CCP level 
command : 

RANDOM X .DAT 

starts the test program. The program looks for a file by the name 
X .DAT (in this particular case) and, if found, proceeds to prompt the 
console for input. If not found, the file is created before the 
prompt is given. Each prompt takes the form 

next command? 

and is followed by operator input, terminated by a carriage return. 
The input commands take the form 

nW nR Q 

where n is an integer value in the range 0 to 65535, and W, R, 
are simple command characters corresponding to random write, 
read, and quit processing, respectively. If the W command is 
the RANDOM program issues the prompt 

type data: 

The operator then responds by typing up to 127 characters, followed by 
a carriage return. RANDOM then writes the character string into the 
X .DAT file at record n. If the R command is issued, RANDOM reads 
record number n and displays the string value at the console. If the 
Q command is issued, the X .DAT file is closed, and the program returns 
to the console command processor. In the interest of brevity, the 
only error message is 

error, try again 

The program begins with an initialization section where the 
input file is opened or created, followed by a continuous loop at the 
label "ready" where the individual commands are interpreted. The 
default file control block at 005CH and the default buffer at 0080H 
are used in all disk operations. The utility subroutines then follow, 
which contain the principal input line processor, called "readc." 
This particular program shows the elements of random access 

processing, and can be used as the basis for further program 
development. 



and Q 
random 
issued , 
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.*************************************************** 

* * 

;* sample random access program for cp/m 2.0 



.*************************************************** 



XJ ± V V 




• 




1 0 0h 

J. XJ XJLl 


* ha s e of t" Da 


0 000 

V V V V 




r 

r phooh 

L ^ \y 




00 00h 

%j *j \j %j i i. 


;system reboot 


(A <A PI R 
U x) t) -J 




uuua 


pan 


0 0 0 5h 

XJ XJ XJ Jll 


• hdos pntfv nni nt 


0001 




foni nn 




1 


t console incut function 


01 0 0 2 

%J fj XJ M» 





con oi 1 1" 


egu 


2 


:console outout function 


0009 


- 


pstr ing 


equ 


9 


;print string until '$' 


000a 


- 


rstr ing 


egu 


10 


;read console buffer 


01 (A Q\c* 

XJ YJ XJ w 






ctj U 


X z 


• r o h nr n \70rQ i nnmhpr 


PI 0 0f 








15 


; f ile open function 


0010 

XJ XJ -L MJ 





p 1 nc;pf 


egu 


16 


: close function 


0016 


= 


makef 


egu 


22 


;make file function 


0021 




readr 


equ 


33 


;read random 


0 0 22 




w r i fpr 

W i» X w C A. 


pan 

C V4 


34 


•write random 


005c 




fcb 


egu 


005ch 


;default file control block 


007d 




ranrec 


egu 


fcb+33 


;random record position 


007f 




ranovf 


egu 


fcb+3 5 


;high order (overflow) byte 


0080 




buff 


egu 


0080h 


;buffer address 


000d 




cr 


egu 


0dh 


;carriage return 


000a 




If 


egu 


0ah 


;line feed 



•***************************^ 

. * * 

;* load SP , set-up file for random access * 
. * * 
.*************************************************** 



0100 


31bc0 


• 


lxi 


sp, stack 






t 
• 


version 


2.0? 


0103 


0e0c 




mvi 


c, version 


0105 


cd050 




call 


bdos 


0108 


fe20 




cpi 


20h ;version 2.0 or better 


010a 


d2160 




jnc 


versok 






• 

t 


bad version, message and go back 


010d 


lllb0 




lxi 


d , bad ver 


0110 


cdda0 




call 


pr int 


0113 


C3000 


• 


jmp 


reboot 






r 

ver sok : 










• 

# 


correct 


version for random access 


0116 


0e0f 




mvi 


c,openf ;open default fcb 


0118 


115c0 




lxi 


d,fcb 


011b 


cd050 




call 


bdos 


011e 


3c 




inr 


a ; err 25 5 becomes zero 


011f 


C2370 


• 


jnz 


ready 






■ 


cannot 


open file, so create it 
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0122 0el6 
0124 115c0 
0127 cd050 
012a 3c 
012b C2370 



012e 113a0 
0131 cdda0 
0134 C3000 



mvi 

lxi 

call 

inr 

jnz 



c, makef 

d, fcb 
bdos 
a 

ready 



;err 255 becomes zero 



; cannot create file, directory full 

lxi d,nospace 
call print 

jmp reboot ;back to ccp 

!*************************************************** 
. * 

j* loop back to "ready" after each command 

* 

.*************************************************** 



* 
* 



ready: 







• 


file 


0137 


cde50 




call 


013a 


22 7d0 




shld 


013d 


217f 0 




lxi 


0140 


3600 




mvi 


0142 


fe51 




cpi 


0144 


C2560 


• 


jnz 






• 


quit 


0147 


0el0 




mvi 


0149 


115c0 




lxi 


014c 


cd050 




call 


014f 


3c 




inr 


0150 


cab90 




jz 


0153 


C3000 




jmp 



file is ready for processing 

readcom ;read next command 
ranrec ;store input record! 
h , ranovf 

m,0 ;clear high byte if set 

' Q 1 ;quit? 
notq 

quit processing, close file 

c, closef 

d, fcb 
bdos 

a ;err 255 becomes 0 

error ;error message, retry 
reboot ;back to ccp 



0156 fe57 
0158 C2890 



015b 114d0 
015e cdda0 
0161 0e7f 
0163 21800 

0166 c5 

0167 e5 

0168 cdc20 
016b el 



.is************************************************** 
. * * 

j* end of quit command, process write * 
. * * 
.it************************************************** 



notq: 



not the quit command, random write? 
cpi 'W 
jnz notw 

; this is a random write, fill buffer until cr 

lxi d,datmsg 
call print ;data prompt 
mvi c,127 ;up to 127 characters 

lxi h,buff ;destination 

rloop: ;read next character to buff 
push b ;save counter 

push h ;next destination 

call getchr ;character to a 
pop h ;restore counter 
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016c cl 
016d fe0d 
016f ca780 

0172 77 

0173 23 

0174 0d 

0175 C2660 



0178 3600 



017a 0e22 

017c 115c0 

017f cd050 

0182 b7 

0183 c2b90 
0186 C3370 



erloop; 



0189 
018b 



fe52 
c2b90 



;restore next to fill 
;end of line? 



pop b 

cpi cr 

jz erloop 
not end, store character 

mov in, a 

inx h ;next to fill 

dcr c ;counter goes down 

jnz rloop ;end of buffer? 

end of read loop, store 00 
mvi m,0 

write the record to selected record number 



mvi 

lxi 

call 

ora 

jnz 

jmp 



c , wr i ter 

d, fcb 
bdos 
a 

error 
ready 



;error code zero? 
;message if not 
;for another record 



*************************************************** 

* * 

* end of write command, process read * 

* * 

*************************************************** 
notw: 

not a write command, read record? 
cpi 'R' 

jnz error ;skip if not 



read random record 



018e 
0190 
0193 
0196 
0197 



019a 
019d 
019f 

01a2 
01a3 
01a4 
01a 6 
01a9 
01aa 
01ab 
01ad 
01b0 
01bl 
01b2 
01b3 
01b6 



0e21 
115c0 
cd050 
b7 

c2b90 



cdcf 0 

0e80 

21800 

7e 
23 

e67f 
ca370 
c5 
e5 

fe20 

d4c80 

el 

cl 

0d 

c2a20 
C3370 



mvi 

lxi 

call 

ora 

jnz 



c , r e ad r 

d, fcb 
bdos 
a 

error 



;return code 00? 



read was successful, write to console 



wloop: 



call 

mvi 

lxi 



mov 
inx 
ani 
jz 

push 

push 

cpi 

cnc 

pop 

pop 

dcr 

jnz 

jmp 



crlf 
c,128 
h,buf f 

a,m 
h 

7fh 
ready 
b 
h 

putchr 

h 

b 

c 

wloop 
ready 



new line 

max 128 characters 
next to get 

next character 
next to get 
mask parity 

for another command if 00 
save counter 
save next to get 
graphic? 

skip output if not 



count=count-l 
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01c2 0e01 
01c4 cd050 
01c7 c9 



*************************************************** 

* * 

* end of read command, all errors end-up here * 

* * 

*************************************************** 



error: 



01b9 11590 

01bc cdda0 
01bf C3370 



lxi 

call 
jmp 



d,errmsg 

print 
ready 



*************************************************** 

* * 

* utility subroutines for console i/o * 

* * 
*************************************************** 

getchr : 

;read next console character to a 
mvi c,coninp 
call bdos 
ret 



01c8 0e02 
01ca 5f 
01cb cd050 
01ce c9 



putchr : 



;write character from a to console 
mvi c,conout 

mov e,a ;character to send 

call bdos ;send character 
ret 



crlf 



01cf 3e0d 

01dl cdc80 

01d4 3e0a 

01d6 cdc80 

01d9 c9 



;send carriage return line feed 

mvi a,cr ;carriage return 

call putchr 

mvi a, If ;line feed 

call putchr 

ret 



print: 



01da d5 
01db cdcf0 
01de dl 
01df 0e09 
01el cd050 
01e4 c9 



;print the buffer addressed by de until $ 



push 
call 
pop 
mvi 
call 
ret 



d 

crlf 

d ;new line 

c,pstr ing 

bdos ;print the string 



read com: 



01e5 116b0 
01e8 cdda0 
01eb 0e0a 
01ed 117a0 
01f0 cd050 



;read the next command line to the conbuf 

lxi d, prompt 

call print ;command? 

mvi c,rstring 

lxi d,conbuf 

call bdos ;read command line 
command line is present, scan it 
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01f3 21000 
01f6 117C0 
01f9 la 
01fa 13 
01fb b7 
01fc c8 



lxi 
lxi 

readc: ldax 
inx 
ora 
rz 

not zero, numeric? 



h, 0 ; start with 0000 

d,conlin; command line 
d ;next command character 

d ; to next command position 

a ; cannot be end of command 



01fd 


d630 




sui 




•0' 




01f f 


f e0a 




cpi 




10 


;carry if numeric 


0201 


d2130 




jnc 




endrd 








• 


add- 


■in 


next digit 


0204 


29 




dad 




h 


; *2 


0205 


4d 




mov 




c,l 




0206 


44 




mov 




b,h 


;bc = value * 2 


0207 


29 




dad 




h 


;*4 


0208 


29 




dad 




h 


; *8 


0209 


09 




dad 




b 


;*2 + *8 = *10 


020a 


85 




add 




1 


;+digit 


020b 


6f 




mov 




l,a 




020c 


d2f90 




jnc 




readc 


;for another char 




2 4 




inr 




h 


; overflow 


0210 


c3f90 




jmp 




readc 


;for another char 






endrd: 












• 

/ 


end 


of 


read, 


restore value in a 


0213 


c630 




adi 




.0. 


; command 


0215 


fe61 




cpi 




•a' 


jtranslate case? 


0217 


d8 




rc 












; 


lower 


:ase, mask lower case bits 
101$llllb 


0218 


e65f 




ani 




0 21a 


c9 




ret 









************************************************** 
* * 



* 

* 





badver : 




021b 


536f79 


db 




nospace: 




0 23a 


4e6f29 


db 




datmsg : 




024d 


547970 


db 




er rmsg : 




0259 


457272 


db 




prompt: 




026b 


4e6570 


db 



* string data area for console messages 
* 

*************************************************** 

'sorry, you need cp/m version 2$' 
'no directory space$ ' 
' type data: $ ' 
'error, try again. $* 
'next command? $' 
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027a 21 
027b 
027c 
0021 = 

029c 
0 2bc 



*************************************************** 

* * 

* fixed and variable data area * 

* * 

*************************************************** 



conbuf : 
consiz: 
conlin: 
conlen 



stack : 



db 
ds 
ds 
equ 

ds 
end 



conlen ;length of console buffer 
1 ;resulting size after read 

32 ; length 32 buffer 

$-consiz 



32 



;16 level stack 



Again, major improvements could be made to this particular 
program to enhance its operation. In fact, with some work, this 
program could evolve into a simple data base management system. One 
could, for example, assume a standard record size of 128 bytes, 
consisting of arbitrary fields within the record. A program, called 
GETKEY, could be developed which first reads a sequential file and 
extracts a specific field defined by the operator. For example, the 
command 

GETKEY NAMES.DAT LASTNAME 10 2 0 

would cause GETKEY to read the data base file NAMES.DAT and extract 
the "LASTNAME" field from each record, starting at position 10 and 
ending at character 20. GETKEY builds a table in memory consisting of 
each particular LASTNAME field, along with its 16-bit record number 
location within the file. The GETKEY program then sorts this list, 
and writes a new file, called LASTNAME. KEY , which is an alphabetical 
list of LASTNAME fields with their corresponding record numbers. 
(This list is called an "inverted index" in information retrieval 

parlance. ) 

Rename the program shown above as QUERY, and massage it a bit so 
that it reads a sorted key file into memory. The command line might 
appear as: 

QUERY NAMES. DAT LASTNAME. KEY 

Instead of reading a number, the QUERY program reads an alphanumeric 
string which is a particular key to find in the NAMES.DAT data base. 
Since the LASTNAME. KEY list is sorted, you can find a particular entry 
quite rapidly by performing a "binary search," similar to looking up a 
name in the telephone book. That is, starting at both ends of the 
list, you examine the entry halfway in between and, if not matched, 
split either the upper half or the lower half for the next search. 
You'll quickly reach the item you're looking for (in log2(n) steps) 
where you'll find the corresponding record number. Fetch and display 
this record at the console, just as we have done in the program shown 
above. 
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At this point you're just getting started. With a little more 
work, you can allow a fixed grouping size which differs from the 128 
byte record shown above. This is accomplished by keeping track of the 
record number as well as the byte offset within the record. Knowing 
the group size, you randomly access the record containing the proper 
group, offset to the beginning of the group within the record read 
sequentially until the group size has been exhausted. 

Finally, you can improve QUERY considerably by allowing boolean 
expressions which compute the set of records which satisfy several 
relationships, such as a LASTNAME between HARDY and LAUREL, and an AGE 
less than 45. Display all the records which fit this description. 
Finally, if your lists are getting too big to fit into memory, 
randomly access your key files from the disk as well. One note of 
consolation after all this work: if you make it through the project, 
you'll have no more need for this manual! 
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6. SYSTEM FUNCTION SUMMARY. 



FUNC 


FUNCTION NAME 


INPUT 


PARAMETERS 


OUTPUT RESULTS 


0 


System Reset 


none 




none 


1 


Console Input 


none 




A = 


char 


2 


Console Output 


E = char 


none 


3 


Reader Input 


none 




A = 


char 


4 


Punch Output 


E = char 


none 


5 


List Output 


E = char 


none 


6 


Direct Console I/O 


see def 


see 


def 


7 


Get I/O Byte 


none 




A = 


IOBYTE 


8 


Set I/O Byte 


E = IOBYTE 


none 


9 


Print String 


DE = 


.Buffer 


none 


10 


Read Console Buffer 


DE = 


. Buffer 


see 


def 


11 


Get Console Status 


none 




A = 


00/FF 


12 


Return Version Number 


none 




HL= 


Version* 


13 


Reset Disk System 


none 




see 


def 


14 


Select Disk 


E = Disk Number 


see 


def 


15 


Open File 


DE = 


. FCB 


A = 


Dir Code 


16 


Close File 


DE = 


. FCB 


A = 


Dir Code 


17 


Search for First 


DE = 


.FCB 


A = 


Dir Code 


18 


Search for Next 


none 




A = 


Dir Code 


19 


Delete File 


DE = 


. FCB 


A = 


Dir Code 


20 


Read Sequential 


DE = 


.FCB 


A = 


Err Code 


21 


Write Sequential 
Make File 


DE = 


.FCB 


A = 


Err Code 


22 


DE = 


.FCB 


A = 


Dir Code 


23 


Rename File 


DE = 


.FCB 


A = 


Dir Code 


24 


Return Login Vector 


none 




HL= 


Login Vect* 


25 


Return Current Disk 


none 




A = 


Cur Disk# 


26 


Set DMA Address 


DE = 


.DMA 


none 


27 


Get Addr(Alloc) 


none 




HL= 


.Alloc 


28 


Write Protect Disk 


none 




see 


def 


29 


Get R/O Vector 


none 




HL= 


R/O Vect* 


30 


Set File Attributes 


DE = 


.FCB 


see 


def 


31 


Get Addr(disk parms) 


none 




HL= 


. DPB 


32 


Set/Get User Code 


see def 


see 


def 


33 


Read Random 


DE = 


. FCB 


A = 


Err Code 


34 


Write Random 


DE = 


.FCB 


A = 


Err Code 


35 


Compute File Size 


DE = 


.FCB 


r0, 


rl, r2 


36 


Set Random Record 


DE = 


.FCB 


r0. 


rl, r2 



* Note that A = L, and B = H upon return 
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7 . ADDENDUM 



NEW CP/M 2.2 
BDOS FUNCTIONS 



* 



FUNCTION 37: RESET DRIVE 



* Entry Parameters 

Register C 

* Register DE 

/* 

* Returned Value : 
Register A: 



25H 

Drive Vector 



00H 



The RESET DRIVE function allows resetting of specified 
drive(s) . The passed parameter is a 16 bit vector of drives 
to be reset, the least significant bit is drive A:. 

In order to maintain compatibility with MP/M, CP/M 
returns a zero value. 



* FUNCTION 40: WRITE RANDOM WITH* 

* ZERO FILL * 

* Entry Parameters: * 

* Register C: 28H 

* Register DE : FCB Address * 

* Returned Value: * 

* Register A: Return Code * 



The WRITE RANDOM WITH ZERO FILL operation is similar 
to FUNCTION 34: with the exception that a previously 
unallocated block is filled with zeros before the data 
is written. 
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